home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / misc / GUIDate.lha / NewDate.doc next >
Encoding:
Text File  |  1993-06-21  |  4.1 KB  |  144 lines
  1.  
  2.  
  3.                           NewDate 1.0
  4.  
  5.                    ©1993 by Alejandro Garza
  6.  
  7. -------------------------------------------------------------
  8.  
  9. A small util to set the system date on those machines unlucky
  10.       enough not to have a battery backed-up clock.
  11.  
  12. -------------------------------------------------------------
  13.  
  14.  
  15. WHAT IS IT?
  16. ================
  17. Err... I thought I mentioned that already.
  18.  
  19.  
  20. WHY IS IT?
  21. ================
  22. Well.. I'm on an A1000 (yes, the few! The proud! The underpowered!) and I
  23. never got around to buying a clock/calendar for it. So one day I just
  24. decided I'd write a nice window interface to set the system date. Neat,
  25. huh?
  26.  
  27. This program will also be of use for all of those who have A1200s without a
  28. built-in clock. Just place in your WBStartup drawer!
  29.  
  30.  
  31. FEATURES
  32. =============
  33. Well, apart from having basically the same syntax as the AmigaDOS 'date'
  34. command (see below) it has a font-sensitive interface, so no matter what
  35. your taste in fonts, this program will adapt to it.
  36.  
  37.  
  38. USAGE
  39. =============
  40.  
  41. Just type from your shell:
  42.  
  43.  
  44.          > NewDate [RETURN]
  45.  
  46.  
  47. or double-click on the WorkBench icon. You can also place on the System
  48. 'WBStartup' drawer and have automatic date requests on startup (which is
  49. the preferred thing to do.)
  50.  
  51. Just type the date in the string gadget (which already contains the current
  52. system date) and either CLOSE the window to exit without changing the
  53. system's date, or press the "Accept" button to save the date.
  54.  
  55. If the date is set incorrectly, the screen will flash (using the
  56. DisplayBeep() function). You must enter a correct date an accept it, or
  57. close the window.
  58.  
  59. You can also type the following: the date and time, only the time, or
  60. nothing at all. Whatever you ommit, will be left as it was.
  61.  
  62. The font used to render the window is the 'WorkBench screen font' used for
  63. window titlebars, etc. You cannot change this.
  64.  
  65.  
  66. BUGS
  67. ============
  68.  
  69. So far, NewDate has a problem with REALLY BIG fonts... bigger than 30
  70. points. But fonts this size won't be appearing on you WorkBench screen font
  71. settings, I think. :) At most, you won't be able to see the entire output..
  72.  
  73. No GURUs so far. I haven't tested for Enforcer hits, but there's no reason
  74. it should provoke any (everything is std. intuition calls).
  75.  
  76. Another problem, although not a bug at all, is that if you want to run some
  77. date-dependent programs (like Reminder-1.20, etc.), you cannot run these
  78. programs from WBStartup, even if you do the same for NewDate. This is
  79. because the date to these programs is still the original system date
  80. (Somewhere around 01-Jan-1978). To get around this, you could insert the
  81. following statements in you user-startup::
  82.  
  83. c:NewDate        ; or wherever you put the NewDate executable
  84. c:ReminderCheck  ; or wherever your date-dependent program is
  85.  
  86. This way, the startup script will pause until you've set the date, and then
  87. it's OK for the date-dependent prog. to execute.
  88.  
  89.  
  90.  
  91.  
  92. TODO
  93. =============
  94.  
  95. Features I'd want to implement::
  96.  
  97. - Support for battery-backed-up clocks
  98. - Save latest date to file, so there'll be little to change if a GURU
  99.   occurs, etc.
  100. - ToolTypes definition of window coordinates
  101.  
  102.  
  103. ETC.
  104. ================
  105.  
  106. Many thanks to all those at IRC patient enough to help me thru this simple
  107. proyect, which is my first real attempt at producing something really
  108. useful. (=^)
  109.  
  110. ..maybe I should've called it CaveDate(TM)... (|^)
  111.  
  112. And also, thanx to the original Amiga 'Lorraine' team (Mr. Miner and
  113. such...) which dreamed up the computer of my dreams, which I still use on a
  114. daily basis.
  115.  
  116.  
  117. WHO MADE THIS?
  118. =====================
  119.  
  120. This program and docs are ©1993 Alejandro Garza. This program may be
  121. distributed freely as long as the Docs and binaries are kept intact. You
  122. are not forced to send me any money, free computers, etc. but instead
  123. E-Mail me for comments, bug reports, etc.
  124.  
  125. I can be reached at the following addresses:
  126.  
  127.   Alejandro Garza González
  128.   Rio Rhin #514 pte.
  129.   Col. del Valle
  130.   Garza García, N.L.  CP 66220
  131.   MEXICO
  132.  
  133.   E-Mail: jano@men_at_work.mty.itesm.mx
  134.      IRC: JanusMan
  135.  
  136. Be free to drop a note saying hi anytime! Also, check out my gfx work at
  137. AmiNet (look for stuff 'made by JanusMan') :)
  138.  
  139. Bye for now!
  140.  
  141.  
  142.  
  143.  
  144.